v6.0.4

Compare Source

Patch Changes

• #​838
  8ba9ac7
  Thanks @​danez! - Support index types correctly in
  flow

v6.0.3

Compare Source

Patch Changes

• #​830
  c3c16e3
  Thanks @​danez! - Fixed error with object and array
  patterns in function signatures.

v6.0.2

Compare Source

Patch Changes

• #​810
  ddf4e20
  Thanks @​danez! - Read docblock in nested flow
  object types and use them as descriptions

v6.0.1

Compare Source

Patch Changes

• #​806
  c7e2bd5
  Thanks @​danez! - Make docblocks for assigned
  methods be correctly detected.

v6.0.0

Compare Source

Major Changes

• 96d6e9e
  Thanks @​danez! - Rename flowTypeHandler to
  codeTypeHandler because it handles Flow and TypeScript

• #​719
  d7a39af
  Thanks @​danez! - Refactored
  resolveComponentDefinition utility.

  • Renamed to findComponentDefinition
  • Removed named export isComponentDefinition
  • The utility now does a lot more than previously, check out the commit to see
    the changes in detail.

• #​761
  dfc2f85
  Thanks @​danez! - Renamed propDocBlockHandler to
  propDocblockHandler for consistency

• 96d6e9e
  Thanks @​danez! - Simplify
  resolveObjectValuesToArray and remove type handling. None of the code that
  was handling types was used.

• caae6bf
  Thanks @​danez! - The return values of
  resolveObjectValuesToArray are now in the order they are defined in the
  source code.

• #​744
  e956802
  Thanks @​danez! - Removed match utility.

  The utility can be replaced by babel helpers and is not needed anymore. Also
  using explicit checks like path.isMemberExpression() is better for type
  safety and catching potential bugs.

• 96d6e9e
  Thanks @​danez! - Migrate react-docgen to ES
  modules. Please read
  this

• #​693
  3b28f6e
  Thanks @​danez! - The CLI was removed from
  react-docgen into its own package @react-docgen/cli.

  Check out https://react-docgen.dev/docs/getting-started/cli for the
  documentation.

• 96d6e9e
  Thanks @​danez! - The main parse API had some
  breaking changes.

  • The arguments were changed from previously 5 to just 2. The following diff
    illustrates how to migrate:

    -parse(src, resolver, handlers, importer, options: { filename, ...babelOptions})
    +parse(src, { resolver, handlers, importer, filename, babelOptions: {} })

  • The return type is now always an array, independent of the resolver, even if
    only one component was found in the file.

• #​786
  0a2481d
  Thanks @​danez! - Renamed the method toObject to
  build in the DocumentationBuilder.

  This method might be used by integrations.

• 96d6e9e
  Thanks @​danez! - Renamed some of the main exports
  for clarity.

  Renamed handlers to builtinHandlers Renamed resolver to
  builtinResolvers Renamed importers to builtinImporters

• #​743
  5215bab
  Thanks @​danez! - Removed support for the
  @extends React.Component annotation on react class components.

  Instead, you can use the new @component annotation or define your own
  annotation by creating a custom FindAnnotatedDefinitionsResolver instance

• #​714
  80e4c74
  Thanks @​danez! - Renamed and migrated built-in
  resolvers to classes.

  • findAllComponentDefinitions was renamed to FindAllDefinitionsResolver
    and is now a class.

    -const resolver = builtinResolvers.findAllComponentDefinitions
    +const resolver = new builtinResolvers.FindAllDefinitionsResolver()

  • findAllExportedComponentDefinitions was renamed to
    FindExportedDefinitionsResolver and is now a class.

    -const resolver = builtinResolvers.findAllExportedComponentDefinitions
    +const resolver = new builtinResolvers.FindExportedDefinitionsResolver()

  • findExportedComponentDefinition was removed. Use
    FindExportedDefinitionsResolver with the limit option instead.

    This is still the default resolver.

    -const resolver = builtinResolvers.findExportedComponentDefinition
    +const resolver = new builtinResolvers.FindExportedDefinitionsResolver({ limit: 1 })

• 96d6e9e
  Thanks @​danez! - Migrated to babel toolchain

  This is one of the big changes in this new version of react-docgen. It made
  the code a lot more robust because there are now finally working TypeScript
  types for the ASTs.

  Another benefit from this change is that react-docgen is now a lot faster. 🚀
  In some tests an improvement of nearly 50% was seen in comparison to
  version 5.

• #​707
  d4c27d4
  Thanks @​danez! - Improve performance of file
  system importer.

  The file system importer now also caches the resolving of files in addition to
  parsing files. If the importer is used in an environment where files do change
  at runtime (like a watch command) then the caches will need to be cleared on
  every file change.

• 96d6e9e
  Thanks @​danez! - Changed the minimum Node.js
  version to 14.18.0

Minor Changes

• 96d6e9e
  Thanks @​danez! - Add support for .cts and .mts
  extension when using typescript

• 96d6e9e
  Thanks @​danez! - Treat functions returning
  React.Children.map as components

• 96d6e9e
  Thanks @​danez! - Improve performance by creating
  all visitors only once

• 96d6e9e
  Thanks @​danez! - Support all possible kinds of
  functions in the displayNameHandler

• #​786
  0a2481d
  Thanks @​danez! - Export the type for the
  DocumentationBuilder.

• #​786
  0a2481d
  Thanks @​danez! - The types NodePath and
  babelTypes are now exported.

  These types are useful when building integrations in TypeScript.

  babelTypes includes all types from @babel/types.

• #​714
  80e4c74
  Thanks @​danez! - Add the new ChainResolver which
  allows multiple resolvers to be chained.

  import { builtinResolvers } from 'react-docgen';
  
  const { ChainResolver } = builtinResolvers;
  const resolver = new ChainResolver([resolver1, resolver2], {
    chainingLogic: ChainResolver.Logic.ALL, // or ChainResolver.Logic.FIRST_FOUND,
  });

• 96d6e9e
  Thanks @​danez! - Support all literal types in
  typescript

• 96d6e9e
  Thanks @​danez! - Support flow qualified type names

• 96d6e9e
  Thanks @​danez! - Support class and function
  declarations without identifier

• 96d6e9e
  Thanks @​danez! - Support resolving of
  destructuring in resolveToValue

• #​714
  80e4c74
  Thanks @​danez! - Allow resolvers to be classes in
  addition to functions.

  import type { ResolverClass, ResolverFunction } from 'react-docgen';
  
  // This was the only option until now
  const functionResolver: ResolverFunction = (file: FileState) => {
    //needs to return array of found components
  };
  
  // This is the new class resolver
  class MyResolver implements ResolverClass {
    resolve(file: FileState) {
      //needs to return array of found components
    }
  }
  
  const classResolver = new MyResolver();

• 96d6e9e
  Thanks @​danez! - Improve performance drastically
  by making changes to AST traversal

  Visitors are now pre-exploded and are cached in the module scope instead of
  creating them on every call. This change brought the benchmark from 170ops/s
  to 225ops/sec

• 96d6e9e
  Thanks @​danez! - Add codes to errors to be able to
  easily detect them

  There is a new export ERROR_CODES that contains all possible error codes.
  The two errors that have codes right now are:

  • MISSING_DEFINITION: No component found in a file
  • MULTIPLE_DEFINITIONS: Multiple components found in one file

• 96d6e9e
  Thanks @​danez! - Support handling
  useImperativeHandle correctly

• #​743
  5215bab
  Thanks @​danez! - Added a new resolver that finds
  annotated components. This resolver is also enabled by default.

  To use this feature simply annotated a component with @component.

  // @​component
  class MyComponent {}

Patch Changes

• #​745
  8fe3dbf
  Thanks @​danez! - Fix crash when using TypeScript
  mapped types

• #​789
  7c99f15
  Thanks @​danez! - Fix TypeScript types when strict
  null checks are disabled

• 96d6e9e
  Thanks @​danez! - Handle React.forwardRef calls
  without a function

• 96d6e9e
  Thanks @​danez! - Fixed the handling of some edge
  cases in resolveToValue

• 96d6e9e
  Thanks @​danez! - Remove trailing commas and
  semicolons from raw values in the documentation

• #​767
  a684d82
  Thanks @​danez! - Fix handling of PropTypes.oneOf
  to handle unresolved imported values correctly

• #​761
  cc94da2
  Thanks @​danez! - Fix using react-docgen in
  browsers

• #​761
  98a1138
  Thanks @​danez! - Add displayName and
  description to Documentation type

• 96d6e9e
  Thanks @​danez! - Parse jsdoc comments for
  TypeScript structs

• #​748
  ea25b16
  Thanks @​danez! - Handle cyclic references in
  PropTypes shape() and exact() methods.

• #​787
  5a226ac
  Thanks @​danez! - Fix @​babel/traverse import to
  work in non ESM environments

• 96d6e9e
  Thanks @​danez! - Correctly handle ObjectProperties
  in isReactComponentMethod

• #​747
  1aa0249
  Thanks @​danez! - Handle typeof import('...') and
  typeof MyType.property correctly in TypeScript

• 050313d
  Thanks @​danez! - Correctly add LICENSE file to
  published packages

• 96d6e9e
  Thanks @​danez! - Add support for TSAsExpressions
  when trying to stringify expressions

• #​720
  f6e4fe7
  Thanks @​renovate! - Update dependency
  strip-indent to v4

• #​769
  e08e08d
  Thanks @​danez! - Correctly resolve the values in
  an Object.values() call